home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / desktop / neotrash.arc / TRASHCAN.DOC < prev    next >
Text File  |  1990-01-09  |  19KB  |  391 lines
  1.                        NeoDesk Recoverable Trashcan
  2.  
  3.                                     by
  4.                                 Dan Wilga
  5.  
  6.          Copyright © 1990 Gribnif Software, All Rights Reserved.
  7.  
  8.      This item is "freeware".  There is no charge to use it.  It is the 
  9. property of Gribnif Software and may not be sold, traded, distributed, or 
  10. marketed by anyone else without the explicit written permission of Gribnif 
  11. Software.
  12.  
  13. Description
  14. -----------
  15.  
  16.      The NeoDesk Recoverable Trashcan is a special desk accessory which 
  17. hooks directly into NeoDesk 2.05 (or later).  It adds to NeoDesk a brand 
  18. new trashcan which can restore any files that were deleted through it.
  19.  
  20.      This "NeoDesk Accessory" is possible thanks to the new "NeoDesk 
  21. Developer's Kit" which lets you write your own new and exciting utilities 
  22. which can hook directly into NeoDesk.  It can be used to call many of the 
  23. NeoDesk functions directly from your own accessories.  Some additional 
  24. information about the "NeoDesk Developer's Kit" and "NeoDesk Accessories" 
  25. is available at the end of this file.
  26.  
  27. Files in this archive
  28. ---------------------
  29.  
  30.      This archive should include the following files.  If it does not you 
  31. are probably using a modified archive.  We recommend you delete it and 
  32. attempt to get one which is complete.
  33.  
  34.      1. TRASHCAN.ACC - The Recoverable Trashcan desk accessory.
  35.      2. TRASHCAN.RSC - The Recoverable Trashcan's resource file.
  36.      3. TRASHCAN.DOC - The documentation file you are reading now.
  37.      4. TRASHCAN.NIC - New icon for Recoverable Trashcan.
  38.      5. PATCH205.PRG - Program to patch earlier copies of NeoDesk 2.05.
  39.      6.  NEO_ACC.INF - File that tells NeoDesk what "NeoDesk Accessories" 
  40.                        you are running.
  41.  
  42. Requirements
  43. ------------
  44.  
  45.      To use the Recoverable Trashcan you need NeoDesk 2.05 (or later).  
  46. You can see what version you are running by looking under the "About 
  47. NeoDesk..." menu entry.  If you are running a version older than 2.05 then 
  48. you will have to upgrade for the Recoverable Trashcan to work.  You can 
  49. find more information on upgrading below.
  50.  
  51. Patching NeoDesk
  52. ----------------
  53.  
  54.      Some earlier copies of NeoDesk 2.05 are only able to utilize one 
  55. "NeoDesk Accessory" at a time.  This can easily be fixed by running the 
  56. included patch program.  The patch program will not affect copies of 
  57. NeoDesk that have already been patched (and thus were fine to start with).  
  58. Just follow these simple instructions:
  59.  
  60.      1. Make a backup of NeoDesk (just in case something goes wrong).
  61.      2. Run the PATCH205.PRG that was included with this archive.
  62.      3. Follow the on-screen instructions.
  63.  
  64.      Technical types might be interested in knowing that the patch simply 
  65. consist of changing the data in the NEODESK.EXE file at offset 421E from 
  66. "0C46 000A 6C0E" to "5246 4E71 4E71", something that you can easily do 
  67. with our freeware MEMFILE editor accessory.
  68.  
  69. Installing it
  70. -------------
  71.  
  72.      To install the Recoverable Trashcan accessory copy the TRASHCAN.ACC 
  73. and TRASHCAN.RSC files to your boot disk.  A boot disk is whatever disk 
  74. you normally utilize to turn on your computer.  This could be a hard disk 
  75. or a floppy disk.  Consult your NeoDesk manual if you have any questions.
  76.  
  77.      You must also copy the included NEO_ACC.INF file to the same 
  78. directory where you store NeoDesk.  This file tells NeoDesk the filename 
  79. of any "NeoDesk Accessories" which you might be running, in this case the 
  80. Recoverable Trashcan.  If you already have a NEO_ACC.INF file then you 
  81. should edit it so that it has the trashcan accessory in it.  The 
  82. NEO_ACC.INF file stores a list of all the "NeoDesk Accessories" that 
  83. NeoDesk should look for.
  84.  
  85.      Once you have installed both the Recoverable Trashcan accessory and 
  86. the NEO_ACC.INF file you can then reboot your system and load NeoDesk.  
  87. Once loaded you can open a window to your boot disk and drag the 
  88. TRASHCAN.ACC file to your desktop.  Make sure you place it in a convenient 
  89. place on the desktop, since the icon for the Recoverable Trashcan 
  90. accessory will now become your new trashcan.  You should also make sure 
  91. you "Save Desktop" so that the icon will remain there every time you 
  92. reboot the system.
  93.  
  94. Custom Icon
  95. -----------
  96.  
  97.      Now you have to give the trashcan a new custom icon (so that it will 
  98. look like a trashcan and not like a desk accessory).  You can either edit 
  99. your own or use the one we have included.
  100.  
  101.      If you edit your own you must remember that the custom icons in the 
  102. icon editor are processed from left to right, top to bottom.  What this 
  103. means is that if you want to create a custom icon for TRASHCAN.ACC you 
  104. must make sure that you place it before the "*.ACC" icon that is already 
  105. in there or your new TRASHCAN.ACC icon will be ignored.  You can insert a 
  106. new icon by dragging the "New Icon" icon and releasing it over any of the
  107. icons inside the icon editor windows.
  108.  
  109.      If you wish to use the icon that we have included you must make sure 
  110. that you first create a new icon (before the "*.ACC" icon).  Then load the 
  111. TRASHCAN.ACC icon from the enclosed TRASHCAN.NIC file.  You can then copy 
  112. the loaded icon to the new icon you created.  Make sure you delete the one 
  113. you loaded after you have copied it to the one you created.
  114.  
  115. Operation
  116. ---------
  117.  
  118.      Use the Recoverable Trashcan just like the older standard trashcan.  
  119. Any items (files or folders) you drag to it will be deleted from your 
  120. windows.  It works on hard disks, ram disks, and floppy disks.  The big 
  121. difference is that these deleted items will still be available "inside" 
  122. the trashcan.  You can access the trashcan contents by double-clicking on 
  123. the trashcan or opening its desk accessory entry under the "NeoDesk" menu.
  124.  
  125.      You may also choose to remove the older trashcan (so you will not get 
  126. confused and delete something in the wrong trashcan) by selecting it and 
  127. choosing the "Remove" option under the "Install Desktop Icon..." menu 
  128. entry.
  129.  
  130.      You CANNOT use this new trashcan to 'remove' desktop icons from your 
  131. desktop.  That is still a feature of the original trashcan.  The 
  132. Recoverable Trashcan will attempt to delete the actual item associated with
  133. any icon you drag to it, regardless of whether it is a desktop icon or not.
  134. You can still select any icon from the desktop and remove it using the
  135. "Install Desktop Icon..." menu entry.
  136.  
  137.      The contents of the trashcan are displayed in a special dialog box.  
  138. The drive buttons to the right indicate what drive you are presently 
  139. looking looking at.  The scroll area to the left will list any deleted 
  140. items (files or folders) in that drive which can be recovered with the 
  141. Recoverable Trashcan.  These items are sorted alphabetically by path and 
  142. name.  Folders will be indicated by the standard "folder character" to the 
  143. left of any folder names.
  144.  
  145.      If there are more items than fit in the scroll area you can use the 
  146. arrows in the vertical scroll bar to see them.  In theory the Recoverable 
  147. Trashcan can handle an unlimited number of deleted items per drive.  The 
  148. horizontal scroll bar lets you read any filenames which (due to their long 
  149. path) are too long to fit in the scroll area.
  150.  
  151.      By clicking on the appropriate "d", "t", or "s" button you can change 
  152. the display to the right of an item's name to show that item's date, time,
  153. or size.
  154.  
  155.      If any items are displayed with a "gray field" over the filename that 
  156. signifies that the items' paths no longer exist.  That means that when you 
  157. restore them, you will have to create the folders that they require.  In
  158. color, this "gray field" is displayed with as a "red field".
  159.  
  160.      There is also an option, to the right, to turn on or off the 
  161. confirmation the trashcan gives every time you drag something to it.  This 
  162. option is permanently saved in the TRASHCAN.RSC file whenever you change 
  163. it and then quit out of the trashcan.
  164.  
  165.      You can select any item or group of items by using the mouse.  Any 
  166. item you select will remain selected even if you scr